home *** CD-ROM | disk | FTP | other *** search
/ Our Solar System / Our Solar System.iso / simul / cosms807 / cosmos.doc next >
Text File  |  1989-04-30  |  54KB  |  1,926 lines
  1.  
  2.  
  3.  
  4.  
  5.                            C O S M O S
  6.  
  7.                       Planetarium Simulator
  8.  
  9.                           Version 8.07
  10.                        Copyright 1988,1989
  11.  
  12.                          April 30, 1989
  13.                                              
  14.                          by Gene W. Lee
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                     Table of Contents
  57.  
  58.  
  59.  
  60.  
  61. Introduction                                            3
  62. Horizon Display Description                             4
  63. Zenith Display Description                              5
  64.   Pick Mode                                             6
  65. Orbital Display Description                             7
  66. Ecliptic Orbital Display Description                8
  67. Planet Size Display                                     8
  68. Planet Position Display                                 9
  69. Planet Distance Display                                 9
  70. Planet Rise Times Display                               9
  71. Menu Descriptions                                       10
  72.   a. Main Menu                                          10
  73.   b. Star Setup Menu                                    12
  74.   c. Time Setup Menu                                    13
  75.   d. Location Setup Menu                                14
  76.   e. Planet Setup Menu                                  14 
  77. Files used by the program                               15
  78.   a. STARFILE                                           15
  79.   b. MENU.SAV                                           16
  80.   c. COSMOS.DOC                                         16
  81.   d. COSMOS.EXE                                         16
  82. Technical Notes                                         16
  83.   a. GMT Time / Local Time /Daylight Savings Time       16
  84.   b. Phase                                              16
  85.   c. Altitude and Azimuth                               17 
  86.   d. AU Astronomical Units                              17
  87.   e. Formulas used by the program                       17
  88.   f. Development System                                 17
  89.   g. Program Accuracy                                   17
  90.   h. Astronomical Experiments                           18
  91.   i. History of Enhancements                            20
  92.   j. Caveats                                            25
  93.   k. Program Call                                       26
  94.   l. COSMOS Environment Variable                        26
  95. Terms of License                                        28
  96. Copyright Notice                                        29
  97. Index                                                   32
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  Introduction 
  112.  
  113. Cosmos  is a program which provides astronomical simulations  the 
  114. same  way a planetarium does. Cosmos will show the past,  present 
  115. and future skies as viewed from Earth. It also shows the position 
  116. of  the planets in orbit around the Sun and gives  specific  data 
  117. about the celestial bodies.
  118.  
  119. Program  options allow the user to select date/time  of  display, 
  120. direction  of  view,  viewer's  latitude  and  longitude,  screen 
  121. updating parameters and much more.
  122. Using  the  display  updating parameters  Cosmos  can  display  a 
  123. complete  days  movement  of  the  heavens,  or  demonstrate  the 
  124. retrograde  motion  of the planets by displaying the sky  at  the 
  125. same time each consecutive day. 
  126.  
  127. Cosmos was written on a UNISYS IT with EGA graphics and a  80287. 
  128. The  program is intended to run on any DOS system that  has  VGA, 
  129. EGA, CGA or Hercules graphics.  Although the program will run  in 
  130. CGA  mode,  the  display  is very poor because  of  the  lack  of  
  131. resolution  and  colors. If you must use CGA  mode,  try  forcing 
  132. Monochrome Hires mode.  See program call options for details.
  133.  
  134. The  program will also run with or without a  math  co-processor, 
  135. however, it is painfully slow without one because of the  intense 
  136. floating point arithmetic involved. 
  137.  
  138.  
  139. If  the  version number displayed on the first screen  ends  with 
  140. '(Limited)',  this  version of Cosmos is being distributed  as  a 
  141. Limited Demonstration version.  Its limitations are that it  will 
  142. work  only for the years 1986 through 1988 and that  it  includes 
  143. less stars in the data base.  The Full Function version will work 
  144. between the years 1700 and 2500.  The full function version  also 
  145. includes over 2100 stars and messier objects.
  146. The  Full Function version can be requested by sending a  support 
  147. donation using the form at the end of this document.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  Horizon Display Description 
  167.  
  168. The  Horizon display attempts to show the sky as seen from  Earth  
  169. when looking in specified direction at a specific time of day.  
  170. The left side of the display is what would be seen over your left 
  171. shoulder as is the right side over your right shoulder.  The  top 
  172. of  of  the display shows what you would see directly  over  your 
  173. head.   You  must  realize  that  distortion  increases  as   you 
  174. approach  the edges of the arc. Another way to think of what  the 
  175. display is representing is image you are sitting in the middle of 
  176. the planetarium.  You see in front of you half of the dome.   The 
  177. difference  is that at the planetarium your field of  view  would 
  178. not  be large large enough to see the complete half dome  all  at 
  179. one time, and with the program the complete half dome is  plotted 
  180. on the screen.
  181.  
  182. The  Moon  is drawn in its approximate phase with  the  New  Moon 
  183. represented   with an empty circle. The drawing of the  phase  of 
  184. the Moon is rounded to the nearest quarter ( New, First  Quarter, 
  185. Half, Third Quarter, Full, etc.).
  186.  
  187. By  using menu selections you can control the brightness  of  the  
  188. stars,  direction  of view, select Real Time display  or  a  User 
  189. defined   time,  change the update rate of the display  and  much 
  190. more.  
  191.  
  192. As  in all displays the Escape key exits from the  display.   See 
  193. the Display Help menu for more information. 
  194.  
  195. Note  that the time and date displayed at the top of  the  screen 
  196. represent  Local Time and assume that the system clock is set  to  
  197. daylight  savings time when applicable ( see technical notes  for 
  198. more details on daylight savings time ).   When 'Leave Trails' is 
  199. turned on the time/date displayed on the left are the start  time 
  200. and the time/date on the right are the current time. 
  201.  
  202.  
  203.      CONTROL KEYS for this display are: 
  204.  
  205.            p: Pause the updating of this display and put the
  206.               display in PICK mode (See Pick Mode)
  207.  
  208.           Escape: Exit Pause/Pick Mode.
  209.  
  210.            s: Pick Star while in Pick Mode. Any key press 
  211.                releases pick.
  212.  
  213.            h:  Highlight  all  stars in  the  constellation  that                
  214.                contains the star that has been Picked.
  215.  
  216.            l: Dump current screen to an IBM compatible printer
  217.                (Best results are obtained in EGA Mode)
  218.  
  219.        left/right arrows: scroll display view to the left/right.
  220.                            ( changes view direction )
  221.  
  222.  Zenith Display Description 
  223.  
  224. The  Zenith display attempts to show the sky as seen  from  Earth  
  225. when looking directly over head at a given time of day.  
  226. The top of the display represents the compass direction of North,
  227. Down  is  South, Right is to the West and the left  side  of  the 
  228. circle  is  toward  the  East horizon   You  must  realize  that 
  229. distortion  increases as  you approach the edges of  the  circle, 
  230. especially for small values of View Angle. 
  231.  
  232. The Zenith View Angle specifies the lowest Altitude an object may 
  233. have  and still be plotted on the display.  For example, if  Zero 
  234. is entered, then all object who's altitude is currently above the 
  235. horizon  will be plotted.  If 89 is entered, only  objects  who's 
  236. current  altitude  is greater than 89 will be display,  thus  the 
  237. effective  view  angle  is  only objects  within  one  degree  of 
  238. vertical. 
  239. The  Moon  is drawn in its approximate phase with  the  New  Moon 
  240. represented   with an empty circle. The drawing of the  phase  of 
  241. the Moon is rounded to the nearest quarter ( New, First  Quarter, 
  242. Half, Third Quarter, Full, etc.).
  243.  
  244. By  using menu selections you can control the brightness  of  the  
  245. stars,  direction  of view, select Real Time display  or  a  User 
  246. defined   time,  change the update rate of the display  and  much 
  247. more.  
  248.  
  249. As  in all displays the Escape key exits from the  display.   See 
  250. the Display Help menu for more information. 
  251.  
  252. Note  that the time and date displayed at the top of  the  screen 
  253. represent  Local Time and assume that the system clock is set  to  
  254. daylight  savings time when applicable ( see technical notes  for 
  255. more details on daylight savings time ).   When 'Leave Trails' is 
  256. turned on the time/date displayed on the left are the start  time 
  257. and the time/date on the right are the current time. 
  258.  
  259.  
  260.      CONTROL KEYS for this display are: 
  261.  
  262.            p: Pause the updating of this display and put the
  263.               display in PICK mode (See Pick Mode)
  264.  
  265.           Escape: Exit Pause/Pick Mode.
  266.  
  267.            s: Pick Star while in Pick Mode. Any key press 
  268.                releases pick.
  269.  
  270.            h:  Highlight  all  stars in  the  constellation  that                
  271.                contains the star that has been Picked.
  272.  
  273.            l: Dump current screen to an IBM compatible printer
  274.                (Best results are obtained in EGA Mode)
  275.  
  276.  Pick Mode
  277.  
  278. When  in  the HORIZON or ZENITH display modes the  user  has  the 
  279. option  of picking an object on the display to find out  what  it 
  280. is.   If the cursor is within the capture range of an  object  it 
  281. will lock on to that object and display information about it.  If
  282. the  cursor  is  not within the capture range of  an  object  the 
  283. Altitude/Azimuth  and  Right Ascension/Declination  of  the  spot 
  284. selected is displayed.  
  285. After  a  star  has  been Picked, the  user  has  the  option  of 
  286. highlighting  all  stars  which are  in  the  constellation  that 
  287. contains the picked star. 
  288.  
  289.      HOW TO USE THIS FEATURE:
  290.  
  291. While  in the horizon or zenith display modes, press the 'p'  key 
  292. to  enter Pick mode. After all objects on the display  have  been 
  293. updated to reflect the displayed time, Pick mode will be entered. 
  294. Move  the  cursor around the screen by pressing the  arrow  keys.  
  295. For finer cursor movement press the SHIFT key along with an arrow 
  296. key.  When the cursor is pointing at the desired object press 's' 
  297. to  select.   If  the cursor is within the capture  range  of  an 
  298. object  the  cursor will first be repositioned to  point  at  the 
  299. object.   A  pop up window will then appear  which  will  provide 
  300. details about the object.  Included in this information is 
  301.      
  302.      -Altitude and Azimuth (See Technical notes for definition).
  303.  
  304.      -Right Ascension and Declination.
  305.  
  306.      -Apparent Magnitude of the object.
  307.  
  308.      -Constellation the object is part of.
  309.  
  310.      -Name of the object if known.
  311.  
  312.      -Spectral Type of the object.
  313.  
  314.      -Object Type (Star,Double star, Planet, Nebula, etc.).
  315.      
  316. If  an object other than a planet was selected, the user has  the 
  317. option  to Highlight all objects in the constellation  containing 
  318. this object.  To perform highlighting, press the 'h' key when the 
  319. display  directs  you  to do so.  Pressing  any  other  key  will 
  320. release pop up window. 
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  Orbital Display Description 
  332.  
  333. The Orbital Display attempts to show the position of the  planets  
  334. as  they orbit the Sun.  The view is from above the plane of  the 
  335. system  with planets moving counter clockwise around the Sun.  
  336.  
  337. By using the control keys you can zoom in toward the Sun or  back 
  338. away  from it.  The 't' key toggles whether the planets  leave  a 
  339. trail  as  they  move. The control keys will also  allow  you  to 
  340. freeze the motion of the planets. 
  341.  
  342. As in all displays the Escape key exits from the display. See the 
  343. Display Help menu for more information.  
  344.  
  345. Note  that the time and date displayed at the top of  the  screen  
  346. represent  Local  Time  land and assume system clock  is  set  to  
  347. daylight  savings time when applicable ( see technical notes  for 
  348. more  details on daylight savings time ).    When 'Leave  Trails' 
  349. is  turned on the time/date displayed on the left are  the  start 
  350. time and the time/date on the right are the current time. 
  351.  
  352.  
  353.  
  354.      CONTROL KEYS for this display are: 
  355.  
  356.            p: Pause the updating of this display 
  357.  
  358.            t: Toggles whether planets leave a trail as they move 
  359.  
  360.            +: Zooms in on the Sun 
  361.  
  362.            -: Zooms out from the Sun 
  363.  
  364.            r: Restore Default Zoom value
  365.  
  366.            l: Dump current screen to an IBM compatible printer
  367.                (Best results are obtained in EGA Mode)
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  Orbital Display Description 
  387.  
  388. The Ecliptic Orbital Display attempts to show the position of the 
  389. planets   as they orbit the Sun.  The perspective of the view  is 
  390. edge-on as seen from a position in the direction of the bottom of 
  391. the screen on the Orbital Display. 
  392.  
  393. By using the control keys you can zoom in toward the Sun or  back 
  394. away  from it.  The 't' key toggles whether the planets  leave  a 
  395. trail  as  they  move. The control keys will also  allow  you  to 
  396. freeze the motion of the planets. 
  397.  
  398. As in all displays the Escape key exits from the display. See the 
  399. Display Help menu for more information.  
  400.  
  401. Note  that the time and date displayed at the top of  the  screen  
  402. represent  Local  Time  land and assume system clock  is  set  to  
  403. daylight  savings time when applicable ( see technical notes  for 
  404. more  details on daylight savings time ).    When 'Leave  Trails' 
  405. is  turned on the time/date displayed on the left are  the  start 
  406. time and the time/date on the right are the current time. 
  407.  
  408.  
  409.  
  410.      CONTROL KEYS for this display are: 
  411.  
  412.            p: Pause the updating of this display 
  413.  
  414.            t: Toggles whether planets leave a trail as they move 
  415.  
  416.            +: Zooms in on the Sun 
  417.  
  418.            -: Zooms out from the Sun 
  419.  
  420.            r: Restore Default Zoom value
  421.  
  422.            l: Dump current screen to an IBM compatible printer
  423.                (Best results are obtained in EGA Mode)
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  Planet Size Display
  430.  
  431. The  Size display allows the user to visualize the difference  in 
  432. size  between any two planets, the Sun or the Moon.  The  display 
  433. draws  the  two bodies to relative scale and labels them  on  the 
  434. bottom of the display. Above each of the bodies their diameter in 
  435. Miles is given.  The figures which appear between the two  bodies 
  436. shows the ratio of the size of the larger to the smaller one.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  Planet Position Display
  443.  
  444. This screen provides numerical information about the planets, Sun 
  445. and Moon's position as views from Earth.  
  446.  
  447. The right ascension and declination for each body is given  along 
  448. with its Altitude and Azimuth.  
  449. Each  time  a key is pressed ( excluding the Escape key  and  the 
  450. 'A' key)   the   display  time  is  updated  according   to   the 
  451. *Update Mode and the fields are re-calculated and re-displayed.
  452. Pressing  the  'A'  key will cause the  display  to  continuously 
  453. update until another key is pressed.
  454.  
  455. * Refer to Update Mode description of the Setup Time Menu.
  456.  
  457.  
  458.  Planet Distance Display
  459.  
  460. This screen provides numerical information about the planets  and 
  461. Sun.
  462.  
  463. It currently displays the distance from the Earth to each of  the 
  464. Planets  and  the distance from each of the Planets to  the  Sun.  
  465. The  distance  is  measured in Astronomical Units  (AUs)  and  in 
  466. Millions of miles.  AUs are equal to 149.6 Million Kilometers  or 
  467. 92.96 Million Miles. 
  468.  
  469. Each  time  a key is pressed ( excluding the Escape key  and  the 
  470. 'A' key )   the  display  time  is  updated  according   to   the 
  471. *Update Mode and the fields are re-calculated and re-displayed.
  472. Pressing  the  'A'  key will cause the  display  to  continuously 
  473. update until another key is pressed.
  474.  
  475. * Refer to Update Mode description of the Setup Time Menu.
  476.  
  477.  
  478.  
  479.  Planet Rise Times Display
  480.  
  481. This  screen  provides numerical information about  the  planets, 
  482. Moon and Sun rise and set times.
  483.  
  484. This display shows the rise and set time of each of the  planets, 
  485. the Sun and the Moon.  The Total Rise column gives the amount  of 
  486. time  the  body  is above the horizon.  The  Phase  and  Apparent 
  487. Magnitude of each of the bodies are also listed. 
  488.  
  489. Each  time  a key is pressed ( excluding the Escape key  and  the 
  490. 'A' key )   the  display  time  is  updated  according   to   the 
  491. *Update Mode and the fields are re-calculated and re-displayed.
  492. Pressing  the  'A'  key will cause the  display  to  continuously 
  493. update until another key is pressed.
  494.  
  495. * Refer to Update Mode description of the Setup Time Menu.
  496.  
  497.  Menu Descriptions
  498.      
  499. This  section will describe the purpose and function of  each  of 
  500. the menu screens.
  501.  
  502.   a. Main Menu 
  503.  
  504.        DISPLAY TYPE is filled in with the type of  display 
  505.        you  wish  to see. (Refer to  description  of  each 
  506.        display type)
  507.  
  508.           1 -Horizon
  509.           2 -Orbital
  510.           3 -Planetary Data 
  511.           4 -Distance Data 
  512.           9 -Help Menu for Display Control
  513.           0 -Exit Program
  514.  
  515.        VIEW DIRECTION is used to select which way you  are 
  516.        looking  when using the Horizon Display.  Direction 
  517.        is  the  same  as its  measured  using  a  magnetic 
  518.        compass.
  519.  
  520.        ZENITH VIEW ANGLE defines the lowest altitude  that 
  521.        a  body  can be at and still appear on  the  Zenith 
  522.        display
  523.  
  524.        LEAVE  TRAIL  selects  whether the  bodies  on  the 
  525.        Horizon  and Orbital display leave a  trail  behind 
  526.        them as they move. 
  527.  
  528.        SETUP TIME MENU is used to change the display time,
  529.        update mode and update rate. 
  530.  
  531.        SETUP LOCATION MENU allows definition of where  the 
  532.        observer is located on the Earth. 
  533.  
  534.        SETUP  STARS  MENU  is used  to  change  parameters 
  535.        dealing with how stars are displayed on the Horizon 
  536.        Display. 
  537.  
  538.        SETUP  PLANETS MENU is used to  enable/disable  the 
  539.        display of each planet (including Sun and Moon). 
  540.  
  541.        RESTORE  MENU SETUP will reread menu.sav  file  and 
  542.        re-load  the  default menu setup that  the  program 
  543.        start up with.
  544.  
  545.        SAVE MENU SETUP will save the current state of  the 
  546.        menu selections and definitions. 
  547.        NOTE:  The saved menu configuration is read  in  at 
  548.        program  startup.  This  will  enable  you  to  set    
  549.        such things as your longitude and latitude and have 
  550.        them come up as the default every time you run  the 
  551.        program. 
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.        Example,  Go through all the menus setting  up  the 
  608.        parameters the way you they apply to your  specific 
  609.        situation.   Then  select  "Save  Menu  Setup"   by 
  610.        entering a "y" on the Save Menu Setup line followed 
  611.        by pressing the Escape key.  From now on the  menus 
  612.        will  be  setup this way every time you  start  the 
  613.        program. 
  614.  
  615.  
  616.        b. Star Setup Menu 
  617.  
  618.        This  menu is used to configure how stars  will  be 
  619.        displayed when viewing the Horizon Display.   Stars 
  620.        can  be  turned  on  and  off  and  their  apparent 
  621.        magnitude can be adjusted.
  622.  
  623.  
  624.        DISPLAY  STARS  selects whether or  not  stars  are 
  625.        displayed on the Horizon Display ( Note: our Sun is 
  626.        not  considered in the set of stars but is  treated 
  627.        more like a planet) 
  628.  
  629.        FIRST  CUTOFF, Stars with magnitudes between  minus 
  630.        infinity  and the First Cutoff are displayed  in  a 
  631.        high intensity white. 
  632.  
  633.        SECOND  CUTOFF, stars with magnitudes  between  the 
  634.        first cutoff and the second cutoff are displayed in 
  635.        a medium intensity white. 
  636.  
  637.        THIRD  CUTOFF,  stars with magnitudes  between  the 
  638.        second cutoff and the third cutoff are displayed in 
  639.        a low intensity white. 
  640.  
  641.        Stars with magnitudes dimmer than the third  cutoff 
  642.        are not displayed. 
  643.  
  644.        These  cutoff  values allow the user to  limit  the 
  645.        stars  displayed to the stars that can actually  be 
  646.        seen due to the amount of ambient city lights where 
  647.        they are located. 
  648.  
  649.        HIGHLIGHT CONSTELLATIONS determines whether or  not 
  650.        the  constellation  that the PICKED star is  in  is 
  651.        highlighted (See Pick Mode).
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.        c. Time Setup Menu 
  662.  
  663.        This menu is used to define the time for which  the 
  664.        display  in drawn and to define how much time  each 
  665.        consecutive display is advanced.
  666.  
  667.        UPDATE  MODE, If System Clock (0) mode is  selected 
  668.        then the system's clock is used to derive the  time 
  669.        for  each  consecutive  display and  the  value  of 
  670.        Update Rate is ignored.
  671.  
  672.        Values other than System Clock use the User Defined 
  673.        Time  described  below  and  are  incremented  each 
  674.        consecutive  display by adding the Update  Rate  to 
  675.        the displayed time according to the display mode. 
  676.  
  677.        A Sidereal Day is one revolution of the Earth  with 
  678.        reference  to the stars ( instead of the Sun ).  It 
  679.        is approximately equal to 23 hours and 56 minutes. 
  680.  
  681.        A  Lunar  Day is one revolution of the  Earth  with 
  682.        reference to the Moon ( instead of the Sun ). It is 
  683.        approximately equal to 1 day and 50 minutes.
  684.  
  685.        UPDATE RATE defines how much time is added to  each 
  686.        consecutive  display.  It  is used  when  ever  the 
  687.        'System  Clock' Update  Mode is NOT  selected.  See 
  688.        Update Mode definition. 
  689.  
  690.  
  691.        MONTH,  DAY, YEAR, HOUR, MIN, SEC are used  as  the 
  692.        User Defined Time. See Update Mode.
  693.        *  NOTE  *:   User defined  time  is  specified  in    
  694.        Local  Time  including Daylight Savings  Time  when    
  695.        applicable. 
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.        d. Location Setup Menu 
  717.  
  718.        This menu allows the user to define where they  are 
  719.        located  on the planet Earth.  This information  is 
  720.        not used in the Orbital Display.
  721.  
  722.        LONGITUDE  is  the observer's longitude  on  Earth.  
  723.        This value is used in the Horizon Display. West  of 
  724.        the   Prime  Meridian  is  positive  and  East   is 
  725.        nEGAtive. 
  726.  
  727.           Example: Mpls, Mn. is approximately +90
  728.                    Columbus, Ohio is approx.  +80
  729.           
  730.        LATITUDE is the observer's latitude on Earth.  This 
  731.        value is used in the Horizon Display. North of  the 
  732.        Equator is positive and South is negative. 
  733.  
  734.           Example: Mpls, Mn. is approximately +45
  735.                    Columbus, Ohio is approx.  +40
  736.  
  737.        TIME   ZONE   describes  the   difference   between 
  738.        Greenwich time and local time. 
  739.  
  740.        Example : Central Time is a +6. 
  741.                  Eastern Time is a +5.
  742.  
  743.  
  744.  
  745.        e. Planet Setup Menu 
  746.  
  747.        This  menu  is  used to select  which  bodies  will 
  748.        appear  on the displays. Select 'y' to  enable  the 
  749.        display of each body and 'n' to disable it. 
  750.  
  751.        Yes  Carl Sagan, I know, the Sun and Moon  are  not 
  752.        really planets. 
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  Files used by the program 
  773.  
  774. This  section  describes the files used by Cosmos.   It  explains 
  775. their usage and where applicable, their format.
  776.  
  777.        a. STARFILE
  778.  
  779.        This  file contains the star data used  by  Cosmos.  
  780.        Cosmos will read as many of the stars listed in the 
  781.        file as will fit into the available memory on  your 
  782.        system.  This file is in binary format and contains 
  783.        the following information.
  784.  
  785.        - Right Ascension of the object. 
  786.  
  787.        - Declination of the object. 
  788.  
  789.        - Magnitude (apparent) of the object.
  790.  
  791.        - Which constellation the object belongs to.
  792.        This information is shown when a star is PICKED  on 
  793.        the horizon screen.
  794.  
  795.        - The name of the object.
  796.        This information is shown when a star is PICKED  on 
  797.        the horizon screen.
  798.  
  799.        -  Object  Type which gives the type  of  body  the 
  800.        object is.
  801.        i.e. - Star, Double Star, Nebula, etc.
  802.        This information is shown when a star is PICKED  on 
  803.        the horizon screen.
  804.  
  805.        - Spectral Type of the object.
  806.        This information is shown when a star is PICKED  on 
  807.        the horizon screen.
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.        b. MENU.SAV
  827.  
  828.        This is the file used to save the current setup  of 
  829.        the menus. Refer to it's definition under the  Save 
  830.        Setup section of the Main Menu description.
  831.        Every  time  Cosmos is started, this file  is  read 
  832.        ( if it exists ) and the menu default parameter are 
  833.        loaded from it.  This file is also read to  re-load 
  834.        the default menu parameters on the 'restore default 
  835.        menu' option. 
  836.  
  837.  
  838.        c. COSMOS.DOC 
  839.  
  840.        This document. 
  841.  
  842.  
  843.        d. COSMOS.EXE 
  844.  
  845.        The executable program. 
  846.  
  847.  
  848.  
  849.  Technical Notes 
  850.  
  851.  
  852.        a. GMT Time / Local Time /Daylight Savings Time 
  853.  
  854.        Cosmos  thinks in terms of Greenwich Mean Time  but 
  855.        interfaces  with  the user in  Local  Time.  Cosmos   
  856.        uses  the  value  you set in  TIME ZONE  ( see  the 
  857.        Location Menu ) to make this correction.
  858.  
  859.        Your  system  clock should be set  to  the  correct 
  860.        local time.  This includes daylight savings time if 
  861.        applicable.   If  daylight  savings  time  is   not 
  862.        instituted where you are or you do not want to  set 
  863.        your system's clock in daylight saving time, Cosmos 
  864.        can  be  called  with the 'n'  option.   This  will 
  865.        instruct  the program not to make  any  corrections 
  866.        for daylight savings time and will expect the clock 
  867.        to be set to Local Standard time.
  868.  
  869.        NOTE: Daylight Savings Time is assumed to begin  on 
  870.        the  FIRST  Sunday  of April and end  on  the  LAST 
  871.        Sunday of October (U.S. DST). European DST (see the 
  872.        'd' program call option) is assumed to begin on the 
  873.        LAST Sunday of March and end on the LAST Sunday  of 
  874.        September.
  875.  
  876.  
  877.        b. Phase 
  878.  
  879.        The phase of a body is defined as follows:
  880.         ( using the Moon phases as an example )
  881.  
  882.        0,360 degrees is the New Moon.
  883.  
  884.        270 degrees is the first half  ( Waxing half ).
  885.  
  886.        180 degrees is the full Moon.
  887.  
  888.        90 degrees is the last half  ( Waning half ). 
  889.  
  890.        This applies to all other solar system bodies.
  891.  
  892.        c. Altitude and Azimuth
  893.  
  894.        Altitude  and  Azimuth describe the  elevation  and 
  895.        compass direction from the observer. 
  896.  
  897.        Altitude is measured in degrees above the  horizon. 
  898.        0.0  is on the horizon and 90.0 is straight  up.  A 
  899.        negative altitude implies that the object is  below 
  900.        the horizon.
  901.  
  902.        Azimuth is measured in degrees from North.  0.0  is 
  903.        North,  90.0 is East, 180.0 is South and  270.0  is 
  904.        West.
  905.  
  906.        d. AU Astronomical Units
  907.  
  908.        Astronomical  Units are a measure of  length  which 
  909.        are  roughly  equal to the radius  of  the  Earth's 
  910.        orbit around the Sun at its farthest point.  
  911.        1 AU = 149.6 Million kilometers.
  912.  
  913.        e. Formulas used by the program 
  914.  
  915.        The  formulas  used by this  program  were  derived 
  916.        using  the  book  'Practical  astronomy  with  your 
  917.        calculator'   written  by  Duffet   Smith,   Peter. 
  918.        Published  by Press Syndicate of the University  of 
  919.        Cambridge 1979, 1981. 
  920.  
  921.  
  922.        f. Development System 
  923.  
  924.        This  program  was written using Turbo-C 1.5  on  a 
  925.        Unisys IT with an EGA display and a 80287. 
  926.  
  927.        g. Program Accuracy
  928.  
  929.        The  accuracy  of  the  positions  calculated   and 
  930.        plotted vary at most by a couple of minutes of arc.  
  931.        This  will produce plots that are well  within  the 
  932.        needs of an amateur astronomers, however, it should 
  933.        not be used for Celestial navigation.
  934.        
  935.  
  936.        h. Astronomical Experiments
  937.  
  938.        These are just some of the ways you can use  Cosmos 
  939.        to watch the heavens move.  Many more are possible, 
  940.        its up to your imagination.
  941.  
  942.  
  943.        -- Watch a complete day go by in minutes.
  944.  
  945.        To  see the Sun, Moon and the planets traverse  the 
  946.        sky while you watch it a simple task.
  947.        To   see  this  motion  set  the  Update  Mode   to 
  948.        "Increment  by minutes" and set the Update Rate  to 
  949.        four  or five.  Turn off the stars to increase  the 
  950.        display update speed. Look at the southern  horizon 
  951.        and watch the days go by.
  952.  
  953.  
  954.        -- Watch the stars circle the North Star as the    
  955.           Earth rotates through a day.
  956.  
  957.        The  North Star is approximately aligned  with  the 
  958.        Earth's  axis  of rotation. If you  photograph  the 
  959.        northern  sky  with long exposures you will  get  a 
  960.        picture  with the stars forming concentric  circles 
  961.        around the North Star.
  962.        To  create  this picture using Cosmos, set  up  the 
  963.        horizon  display  to view the northern sky  from  a 
  964.        northern  latitude. Turn on  "Bodies Leave Trails". 
  965.        Set the Update Mode to "Increment Minutes" and  the 
  966.        Update Rate to about 5.  As you watch each frame of 
  967.        the display progress the concentric circles appear.
  968.  
  969.  
  970.        -- Watch the Sun's height in the sky at noon change 
  971.           through out the year. 
  972.  
  973.        As  the  Earth  travels around the  Sun  the  angle 
  974.        between  an  observer  on the  Earth  and  the  Sun 
  975.        changes.  On the Winter Solstice the Sun is low  in 
  976.        the  sky  at  noon and on the  Summer  Solstice  it 
  977.        reaches its high point.  
  978.        To see this you can use the program to display  the 
  979.        position  of  the Sun every day at noon.   Set  the 
  980.        "Bodies  Leave Trails" to YES. Set the Update  Mode 
  981.        to  Increment Day and set the Update Rate  to  one.  
  982.        Displaying  the southern horizon you will  see  the 
  983.        Sun  Rise  as Summer approaches and then  began  to 
  984.        fall as Fall leads to Winter.
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.        -- Watch the movement of the Sun during a Summer 
  992.           day above the Arctic Circle. 
  993.  
  994.        At  latitudes above the Arctic Circle the Sun  will 
  995.        not set on the longest day of the year, June 21.
  996.        To  recreate  this  24 hour  day  set  the  viewers 
  997.        latitude to a value between 66.5 and 90.0. Set  the 
  998.        time of display to be June 21 of any year. This can 
  999.        be  accomplished  by  setting the  Update  Mode  to 
  1000.        Increment  Minutes  and the Update  Rate  to  about 
  1001.        five.   If you watch the Suns movement  during  one 
  1002.        full day you will notice that the sun did not  rise 
  1003.        and set but rather that it followed a path of equal 
  1004.        height   around  the  horizon.   If   you   display 
  1005.        Planetary Data (from the main menu) you will notice 
  1006.        that the Rise/Set time for the Sun is "Never Sets".
  1007.  
  1008.  
  1009.  
  1010.        -- Watch the retrograde motion of the planets.
  1011.           
  1012.        The retrograde motion of the planets refers to  the 
  1013.        way  they  wander through the  constellations  from 
  1014.        night  to  night. In fact, the  word  planet  means 
  1015.        wanderer.
  1016.        To  see  this  motion,  set  the  Update  Mode   to 
  1017.        "Increment Sidereal Day" and set the Update rate to 
  1018.        two or three.  This mode updates the display by the 
  1019.        same amount of time it takes the stars to return to 
  1020.        the  same  position  in the  sky  each  consecutive 
  1021.        night.  Turning off the display of the Moon and Sun 
  1022.        is  recommended  for  this experiment  If  you  set 
  1023.        "Bodies  Leave Trails" the planets will draw  their 
  1024.        paths   through   the  stars  as  they   move.    A 
  1025.        recommended  Date/Location setup for  this  display 
  1026.        is; look at the southern horizon from North America 
  1027.        at   Midnight  on  September  first.   With   Stars 
  1028.        displayed  it can take up to fifteen minutes  (with 
  1029.        math co-processor)to get an interesting display. 
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.        i. History of Enhancements
  1047.  
  1048.        Revision 5.73                   5-9-88
  1049.        First Public Release  
  1050.  
  1051.        Revision 5.74                   5-25-88
  1052.        New  Memory Model allows all stars in  starfile  to 
  1053.        fit into memory.
  1054.        Problem  with  program stating "Rename  program  to 
  1055.        cosmos.exe"  when  DOS switch char is  changed  has 
  1056.        been fixed.
  1057.        Attempted  fix for intermittent math error on  some 
  1058.        systems was made.  (time will tell)
  1059.  
  1060.        Revision 5.75                   6-1-88
  1061.        Program uses expanded star file which now  includes 
  1062.        star names/descriptions and also has more stars.
  1063.  
  1064.        Revision 5.76                   6-11-88
  1065.        Added  menu selection to re-read the  default  menu 
  1066.        setup from file MENU.SAV.
  1067.  
  1068.        Revision 5.77                   6-14-88
  1069.        Fixed  two coding bugs which caused floating  point 
  1070.        math errors.
  1071.  
  1072.        Revision 5.78                   6-20-88
  1073.        Test of Star Pick functions (UNRELEASED)
  1074.  
  1075.        Revision 5.79                   6-22-88
  1076.        Changed  format of starfile to binary file.   Stars 
  1077.        load in 1/4 the old load time.
  1078.  
  1079.        Revision 5.80                   6-24-88
  1080.        Fixed bug in program that incorrectly rounded  star 
  1081.        magnitude cutoff values to integers.
  1082.  
  1083.        Revision 5.81                   6-25-88
  1084.        Added  constellation  highlighting feature  when  a 
  1085.        star is Picked (See horizon display for details).
  1086.        This  new menu option causes old menu.sav files  to 
  1087.        become invalid.  Execute Menu Save option again.
  1088.        Changed  the  color  of  Neptune  so  that  it   is 
  1089.        different than Jupiter.
  1090.  
  1091.        Revision 5.82                   6-26-88
  1092.        First version to have Pick cursor working.   Cursor 
  1093.        shape needs more work.
  1094.  
  1095.        Revision 5.83                   6-29-88
  1096.        Method for highlighting constellations changed;  no 
  1097.        longer use menu option to determine whether or  not 
  1098.        to highlight.  Instruction on how to use Pick  Mode 
  1099.        are now given interactively to the user.
  1100.  
  1101.  
  1102.        Revision 5.84                   7-2-88
  1103.        Program  now uses and displays constellation  names 
  1104.        instead of IAU designation.
  1105.  
  1106.        Revision 5.85                   7-3-88
  1107.        Fixed problem that stars which are already  plotted 
  1108.        on  the horizon display are erased because  another 
  1109.        star  tries  to plot on top of  it.  Fixed  problem 
  1110.        where  pick display where it left out the  negative 
  1111.        sign on negative declinations.
  1112.  
  1113.        Revision 5.86                    8-7-88
  1114.        Combined  Program Logo screen and the star  reading 
  1115.        screen into one Logo screen.
  1116.  
  1117.        Revision 5.87                    8-14-88
  1118.        Added  'Up' field to Planetary Data Display.   This 
  1119.        field contains an up-arrow if the body is above the 
  1120.        horizon at the displayed time.
  1121.  
  1122.        Revision 5.88                    8-18-88
  1123.        First  TEST version released with print out  option 
  1124.        on the horizon screen.
  1125.  
  1126.        Revision 5.89                    8-29-88
  1127.        Made changes to the horizon printout routine.  Made 
  1128.        Internal changes.
  1129.  
  1130.        Revision 5.90                    9-6-88
  1131.        Changed  time printout on Horizon display  to  show 
  1132.        start time and current time when 'leave trails'  is 
  1133.        on.  This then shows how long it took to  make  the 
  1134.        trails on the screen.
  1135.  
  1136.        Revision 5.91                    9-9-88
  1137.        Made same change as 5.90 to the Orbit display.
  1138.  
  1139.        Revision 6.00                    9-10-88
  1140.        Fix  to compiler now allows program to be  compiled 
  1141.        using  Huge  model.   This  allowed  the  following 
  1142.        enhancements.
  1143.        Put 'Display Help' function back in.
  1144.        Did more work on Horizon display printout feature.
  1145.        Added screen dump function to the Orbit display.
  1146.        Incorporated .BGI and .CHR files into the  program, 
  1147.        they are no longer needed.
  1148.        Added update increment of 'Lunar Day' to time setup 
  1149.        menu.
  1150.  
  1151.        Revision 6.01                    9-12-88
  1152.        Added 'Planet Distances' display.
  1153.  
  1154.  
  1155.  
  1156.        Revision 6.02                    9-13-88
  1157.        Changed 'Planet Distances' display to show distance 
  1158.        of planets from Sun and from Earth.
  1159.  
  1160.        Revision 6.03                    9-15-88
  1161.        Added distance measurement of Miles on the 'Planets 
  1162.        Distances' display.
  1163.  
  1164.        Revision 6.04                     9-16-88
  1165.        Fixed  memory  allocation problem on  systems  with 
  1166.        256k  of memory. Added messages to confirm  writing 
  1167.        and reading of the menu save file.
  1168.  
  1169.        Revision 6.05                    9-17-88
  1170.        Split   out  Planetary  data  display  into   three 
  1171.        separate  displays.  1-Planet  Positions   2-Planet 
  1172.        distances and 3-Planet rise/set times.
  1173.  
  1174.        Revision 6.06                    9-18-88
  1175.        Added  check in display printout routine  to  check 
  1176.        for printer being off line.
  1177.  
  1178.        Revision 6.07                    9-21-88
  1179.        Cosmos now displays the update mode and rate at the 
  1180.        bottom of the horizon display.
  1181.  
  1182.        Revision 6.08                    9-23-88
  1183.        Total-Rise-Time  column  added  to  the  Rise-Times 
  1184.        display.
  1185.  
  1186.        Revision 6.09                    10-1-88
  1187.        Cursor  (in pick mode) now screen wraps instead  of 
  1188.        stopping at the screen edges.
  1189.  
  1190.        Revision 6.10                    10-22-88
  1191.        Enhanced program to use COSMOS environment variable.  
  1192.        ( see Program Call section of document )
  1193.  
  1194.        Revision 6.11                    11-1-88
  1195.        Added Monochrome (640x200) mode as a valid  display 
  1196.        mode.
  1197.  
  1198.        Revision 6.12                    11-6-88
  1199.        Fixed potential problem with program selecting non-
  1200.        supported advance graphics modes.
  1201.  
  1202.        Revision 6.13                    11-29-88
  1203.        Fixed  problem  of not plotting N.East  stars  when 
  1204.        viewing N.West on the horizon display.
  1205.        Fixed  program so it is now possible to  PICK  (see 
  1206.        pick mode) the North Star. 
  1207.  
  1208.  
  1209.        Revision 6.14                    11-30-88
  1210.        Added support for European Daylight Savings Time.
  1211.  
  1212.        Revision 7.00                    12-06-88
  1213.        Added  display to show the size difference  between 
  1214.        planets ( see Size Display description )
  1215.  
  1216.        Revision 7.01                    12-07-88
  1217.        Upgraded compiler for program to Turbo-C 2.0
  1218.  
  1219.        Revision 7.02                    12-12-88
  1220.        Fixed  problem with program crashing  when  dumping 
  1221.        display to printer in VGA mode.
  1222.  
  1223.        Revision 7.03                    12-13-88
  1224.        Fixed a rare bug in displaying the setting times of 
  1225.        bodies when latitude is at the Arctic Circle.
  1226.  
  1227.        Revision 7.04                    12-17-88
  1228.        Added Reset-Zoom function to Orbit Display.   Fixed 
  1229.        error on the Help Display.
  1230.  
  1231.        Revision 7.05                    12-22-88
  1232.        Added support for Hercules Display mode.
  1233.  
  1234.        Revision 7.06                    12-23-88
  1235.        Cosmos now displays the update mode and rate at the 
  1236.        bottom of the Orbit display.
  1237.  
  1238.        Revision 7.07                    12-24-88
  1239.        Enhanced  PICK Mode to allow a Planet, the  Sun  or 
  1240.        the Moon to be selected.
  1241.  
  1242.        Revision 7.08                    12-26-88
  1243.        Added  Planet  Magnitude information to  the  Rise-
  1244.        Times display and the Pick Mode pop-up windows.
  1245.  
  1246.        Revision 7.09                    12-28-88
  1247.        Fixes made to support Hercules Monochrome Mode.
  1248.  
  1249.        Revision 7.10                    12-30-88
  1250.        Fixed problem with selecting the Moon in Pick  Mode 
  1251.        on Horizon Display.
  1252.  
  1253.        Revision 7.11                    1-3-89
  1254.        Changed  program  to  list  all  valid  options  if 
  1255.        program is started with an invalid option.
  1256.  
  1257.        Revision 7.12                    1-7-89
  1258.        Fixed a bug that would not allow -10,-11 or -12  to 
  1259.        be entered into the TIME ZONE field on the LOCATION 
  1260.        menu.
  1261.  
  1262.        Revision 7.13                    1-10-89
  1263.        Removed  check that would not let user  enter  Pick 
  1264.        Mode  when  no stars had been plotted.  Related  to 
  1265.        change in version 7.07
  1266.  
  1267.        Revision 7.14                    1-23-89
  1268.        Fixed bug that caused intermittent program  crashes 
  1269.        due to floating point math errors.
  1270.  
  1271.        Revision 8.00                    2/7/89
  1272.        Added Zenith Display Mode.
  1273.  
  1274.        Revision 8.01                    2/8/89
  1275.        Added Zenith View Angle control from the main menu. 
  1276.        MENU.SAV  file must be re-created.   MENU.SAV  file 
  1277.        created from previous version can not be used.
  1278.  
  1279.        Revision 8.02                    2/8/89
  1280.        Fix  to  Zenith display to catch picks  being  made 
  1281.        outside the display circle.
  1282.  
  1283.        Revision 8.03                    2/9/89
  1284.        Changed layout of Zenith display to make it  appear 
  1285.        more  as the sky would if looking up. Labeled  West 
  1286.        and East sides of Zenith display. 
  1287.  
  1288.        Revision 8.04                    3/8/89
  1289.        Starfile   fixed  to  label  Cancer   constellation 
  1290.        correctly.  No actual changes to program.
  1291.  
  1292.        Revision 8.05                    3/17/89
  1293.        Added  automatic  updating  feature  to  the   data 
  1294.        displays -Rise Time display, Distance display, etc.
  1295.  
  1296.        Revision 8.06                    4/28/89
  1297.        Added scroll functionality to the HORIZON display.
  1298.  
  1299.        Revision 8.07                    4/30/89
  1300.        Added the Ecliptic Orbit Display.
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.        j. Caveats 
  1323.  
  1324.        Since  this program was written on an  EGA  system, 
  1325.        the displays were optimized to look best in EGA and 
  1326.        VGA  modes.  Although the program does run  in  CGA 
  1327.        mode, the display is of extremely low quality ( due 
  1328.        to  the low resolution ) and is not useful  if  any 
  1329.        detail is required. 
  1330.  
  1331.        The program is very math intensive and needs a math   
  1332.        co-processor to run effectively.  The program  will 
  1333.        run without math co-processor support, however  the 
  1334.        program  becomes  limited in its  display  updating   
  1335.        due  to  the  long calculation times  of  the  math 
  1336.        emulation routines. 
  1337.  
  1338.  
  1339.        If you have a math co-processor and are  interested 
  1340.        in  seeing  just  how slow this  program  will  run 
  1341.        without it, do the following.
  1342.        Before  executing Cosmos ( at the  DOS    prompt ), 
  1343.        type  "set  87=n".   The program,  when  run,  will 
  1344.        detect this value and use floating point  emulation 
  1345.        routines instead of the math chip.
  1346.        Now that you have seen what a good investment  your 
  1347.        math  co-processor  is,  you can  re-enable  it  by 
  1348.        exiting Cosmos and typing "set 87=y". 
  1349.  
  1350.        NOTE: the " (Quotes) were not supposed to be  typed 
  1351.        in. 
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.        k. Program Call 
  1378.  
  1379.        After  moving  to  the  directory  which   contains 
  1380.        Cosmos.exe,  the .BGI and .CHR files, menu.sav  and 
  1381.        the  starfile,  the  program should  be  called  as 
  1382.        follows: 
  1383.  
  1384.             COSMOS {-options} 
  1385.  
  1386.               Current options are:
  1387.  
  1388.               s -Do not pause during title display.
  1389.  
  1390.               n -Do not correct for Daylight Savings Time. 
  1391.  
  1392.               d -Use European Daylight Savings Time Dates.
  1393.  
  1394.               v -Force VGA display mode.
  1395.                     (640x480, 16 colors)
  1396.  
  1397.               e -Force EGA display mode.
  1398.                     (640x350, 16 colors)
  1399.  
  1400.               c -Force CGA display mode.
  1401.                     (320x200, 4 colors, palette 1)
  1402.  
  1403.               m -Force Monochrome display mode.
  1404.                     (640x200, 2 colors)
  1405.  
  1406.               h -Force Hercules display mode.
  1407.                     (720x348, 2 colors)
  1408.  
  1409.          Examples:
  1410.  
  1411.            cosmos -n  
  1412.  
  1413.                       { Would turn off DST correction }
  1414.  
  1415.  
  1416.            cosmos -v -n
  1417.  
  1418.                       { Would turn off DST correction
  1419.                          AND force the program to override
  1420.                          the detected graphics mode and
  1421.                          use VGA graphics display mode
  1422.                          instead.
  1423.  
  1424.  
  1425.        *** NOTE ***:  OPTIONS ARE CASE SENSITIVE.
  1426.  
  1427.        l. COSMOS Environment Variable
  1428.  
  1429.        If there is an environment variable COSMOS set, the 
  1430.        program  will use its value as the path  to  access 
  1431.        the  files used by the program. 
  1432.        As  an example, add the line SET  COSMOS=C:\COSMOS\ 
  1433.        to  the autoexec.bat file (assuming  the  directory 
  1434.        c:\cosmos  contains the cosmos program and all  its 
  1435.        related files).  Now change to any other directory, 
  1436.        say the root directory. Execute the cosmos  program 
  1437.        (c:\cosmos\cosmos).   Cosmos  will now be  able  to 
  1438.        find  its  files  even though you are  not  in  the 
  1439.        cosmos directory.
  1440.           
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  Terms of License 
  1487.  
  1488. As  the licensee of the Full Function Version  (excludes  limited 
  1489. version) of this program, you may use it on one computer.  If you 
  1490. are an individual (but not a company or an institution), you  may 
  1491. use   the  program  on  any  other  computer(s)  that   you   own 
  1492. personally.   Companies and Institutions must register  one  copy 
  1493. per computer or obtain a site license.
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  Copyright Notice 
  1542.  
  1543. Everyone who purchase the full-function version will be  notified 
  1544. of updates and enhancements to the program. 
  1545. If  the  version number displayed on the first screen  ends  with 
  1546. '(Limited)',  this  version of Cosmos is being distributed  as  a 
  1547. Limited Demonstration version.  Its limitations are that it  will 
  1548. work  only for the years 1986 through 1988 and that  it  includes 
  1549. less stars in the data base.  The Full Function version will work 
  1550. between the years 1700 and 2500.  The full function version  also 
  1551. includes over 2100 stars and messier objects.
  1552. The  Full Function version can be requested by sending a  support 
  1553. donation using the form at the end of this document.
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596. Limitations on distribution and use include the following:
  1597.  
  1598.     No responsibilities for the operation of Cosmos is assumed or 
  1599.     implied  by its author.  The user of Cosmos uses the  program 
  1600.     at  their  own risk.  The author assumes no  responsibly  for 
  1601.     damages caused by use of this program.
  1602.     
  1603.     This program and its documentation may not be distributed  if 
  1604.     any changes have been made.
  1605.  
  1606.     The copyright notice and statement of authorship must not  be 
  1607.     modified or removed.
  1608.  
  1609.     All  copies of the Full-Function (Unlimited) version must  be 
  1610.     registered and may not be distributed.
  1611.  
  1612.     Cosmos may not be distributed for profit.
  1613.  
  1614.  
  1615. Use the following form to purchase the Full-Function  (Unlimited) 
  1616. version of Cosmos.
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.     Remit to:                   Gene W. Lee                   Order Form
  1654.                             7500 Colorado Ave N.                 8.07
  1655.                              Brooklyn Park, Mn.
  1656.                                         55443
  1657.  
  1658.     Please send:
  1659.  
  1660.  
  1661.     ____ Cosmos Disk (Full-Function Version)....... @ $ 25.00 ea. $ ____
  1662.             (includes program and manual on disk)
  1663.  
  1664.  
  1665.           (Minnesota residents please add 6.0% sales tax)    Tax    ____
  1666.  
  1667.                                                           Total $ ______
  1668.  
  1669.     Payment by:   ( ) Check drawn on US Bank  ( ) Money Order
  1670.  
  1671.  
  1672.        Name: ____________________________________________________________
  1673.  
  1674.    Organization: ________________________________________________________
  1675.  
  1676.     Address: ____________________________________________________________
  1677.  
  1678.            : ____________________________________________________________
  1679.  
  1680.            : ____________________________________________________________
  1681.  
  1682.     Day Phone:   (___) _________________ Eve:   (___) ___________________
  1683.  
  1684.  
  1685.     ORDERS OUTSIDE THE US: Use check or Money Order drawn on US BANK in
  1686.     US DOLLARS.  Add $5 (per copy) for non-US shipping of orders. 
  1687.  
  1688.     Sorry, no C.O.D. orders will be accepted.                
  1689.  
  1690.     WARNING: YOU MAY NOT USE COSMOS WITHIN YOUR ORGANIZATION WITHOUT A
  1691.     PURCHASE OR LICENSE ARRANGEMENT.   
  1692.  
  1693.     WARNING: The author assumes no responsibility for damages caused by 
  1694.     uses of this program.
  1695.  
  1696.     PRICES SUBJECT TO CHANGE WITHOUT NOTICE.
  1697.  
  1698.  
  1699.                        System Type Survey
  1700.  
  1701.     Computer Type ______________________________________________
  1702.  
  1703.     System Memory _______  Monitor Type ____________   Math Chip _______
  1704.  
  1705.  
  1706.                               Index 
  1707.  
  1708.  
  1709.  
  1710. Actual, 24
  1711. Altitude, 2, 5, 6, 9, 10, 17
  1712. Ambient, 12
  1713. Angle, 5, 10, 18, 24
  1714. Apparent, 6, 9, 12, 15
  1715. Arrows, 4
  1716. Ascension, 6, 9, 15
  1717. AU, 2, 17
  1718. AUs, 9
  1719. Automatic, 24
  1720. Azimuth, 2, 6, 9, 17
  1721. A' key, 9
  1722.  
  1723. Bodies Leave Trails, 18
  1724. Brightness, 4, 5
  1725.  
  1726. Cancer, 24
  1727. Cause, 9
  1728. Caveats, 2, 25
  1729. CGA, 3, 25, 26
  1730. Clock' Update, 13
  1731. Companies, 28
  1732. Company, 28
  1733. Compass, 5, 10, 17
  1734. Constellation, 4, 5, 6, 12, 15, 20, 21, 24
  1735. CONSTELLATIONS, 12, 19, 20
  1736. Continuously, 9
  1737. Copyright, 1, 2, 29, 30
  1738. Correctly, 24
  1739. COSMOS, 2, 3, 15, 16, 18, 20, 22, 23, 25, 26, 27, 29, 30, 31
  1740. Co-processor, 3, 19, 25
  1741.  
  1742. Declination, 6, 9, 15
  1743. Declinations, 21
  1744. Default, 7, 8, 10, 16, 20
  1745. Degree, 5
  1746. Degrees, 17
  1747. Diameter, 8
  1748. Direction, 3, 4, 5, 8, 10, 17
  1749. Distance, 2, 9, 10, 22, 24
  1750. Distances, 21, 22
  1751. Distortion, 4, 5
  1752. Dome, 4
  1753. DOS, 3, 20, 25
  1754. DST, 16, 26
  1755.  
  1756. Earth, 3, 4, 5, 9, 10, 13, 14, 18, 22
  1757. Ecliptic, 8
  1758. Edge-on, 8
  1759. EGA, 3, 4, 5, 7, 8, 17, 25, 26
  1760. Elevation, 17
  1761. Emulation, 25
  1762. Equator, 14
  1763. European, 16, 22, 26
  1764. Excludes, 28
  1765.  
  1766. Full-function, 29, 30, 31
  1767. Functionality, 24
  1768.  
  1769. GMT, 2, 16
  1770. Graphics, 3, 22, 26
  1771. Greenwich, 14, 16
  1772.  
  1773. Height, 18, 19
  1774. Hercules, 3, 23, 26
  1775. Highlight, 4, 5, 6, 12, 20
  1776. Highlighted, 12
  1777. Highlighting, 6, 20
  1778. Horizon, 2, 4, 5, 6, 9, 10, 12, 14, 15, 17, 18, 19, 20, 21, 22, 23, 
  1779.   24
  1780. HOUR, 13, 19
  1781. Hours, 13
  1782.  
  1783. Index, 2, 32
  1784. Individual, 28
  1785. Infinity, 12
  1786. Institution, 28
  1787. Institutions, 28
  1788. Intensity, 12
  1789. Introduction, 2, 3
  1790.  
  1791. Jupiter, 20
  1792.  
  1793. Kilometers, 9, 17
  1794.  
  1795. Label, 24
  1796. Latitude, 3, 10, 14, 18, 19, 23
  1797. Latitudes, 19
  1798. License, 2, 28, 31
  1799. Licensee, 28
  1800. Limitations, 3, 29, 30
  1801. Location, 2, 10, 14, 16, 19, 23
  1802. Longitude, 3, 10, 14
  1803. Lunar, 13, 21
  1804.  
  1805. Magnitude, 6, 9, 12, 15, 20, 23
  1806. Magnitudes, 12
  1807. Math, 3, 19, 20, 24, 25, 31
  1808. Measure, 17
  1809. Measured, 9, 10, 17
  1810. Menu, 2, 4, 5, 7, 8, 9, 10, 12, 13, 14, 16, 19, 20, 21, 22, 23, 24, 
  1811.   26
  1812. Menus, 12, 16
  1813. Meridian, 14
  1814. Messier, 3, 29
  1815. Midnight, 19
  1816. Miles, 8, 9, 22
  1817. Minutes, 13, 17, 18, 19
  1818. Monitor, 31
  1819. Monochrome, 3, 22, 23, 26
  1820. Moon, 4, 5, 8, 9, 10, 13, 14, 16, 17, 18, 19, 23
  1821. Moon's, 9
  1822. Motion, 3, 7, 8, 18, 19
  1823.  
  1824. Navigation, 17
  1825. Nebula, 6, 15
  1826. Neptune, 20
  1827. Night, 19
  1828. Noon, 18
  1829. North, 5, 14, 17, 18, 19, 22
  1830. Northern, 18
  1831.  
  1832. Observer, 10, 17, 18
  1833. Observer's, 14
  1834. Obtain, 28
  1835. Orbit, 3, 7, 8, 17, 21, 23
  1836. Orbital, 2, 7, 8, 10, 14
  1837.  
  1838. Personally, 28
  1839. Perspective, 8
  1840. Phase, 2, 4, 5, 9, 16
  1841. Phases, 16
  1842. Pick, 2, 4, 5, 6, 12, 20, 21, 22, 23
  1843. Picked, 4, 5, 6, 12, 15, 20
  1844. Picking, 6
  1845. Picks, 24
  1846. Planet, 2, 6, 8, 9, 10, 12, 14, 19, 21, 22, 23
  1847. Planetarium, 1, 3, 4
  1848. Planetary, 10, 19, 21, 22
  1849. Planets, 3, 7, 8, 9, 10, 14, 18, 19, 22, 23
  1850. Plot, 21
  1851. Plots, 17
  1852. Plotted, 4, 5, 17, 21, 23
  1853. Plotting, 22
  1854. Point, 3, 6, 17, 18, 20, 24, 25
  1855. Pointing, 6
  1856. Print, 21
  1857. Printer, 4, 5, 7, 8, 22, 23
  1858. Printout, 21, 22
  1859.  
  1860. Rate, 4, 5, 10, 13, 18, 19, 22, 23
  1861. Ratio, 8
  1862. Register, 28
  1863. Reset-Zoom, 23
  1864. Resolution, 3, 25
  1865. Retrograde, 3, 19
  1866. Revolution, 13
  1867. Rise, 2, 9, 18, 19, 22, 24
  1868. Rise-Times, 22, 23
  1869. Rotates, 18
  1870. Rotation, 18
  1871.  
  1872. Scroll, 4, 24
  1873. Sidereal, 13, 19
  1874. Site, 28
  1875. Skies, 3
  1876. Sky, 3, 4, 5, 18, 19, 24
  1877. Solar, 17
  1878. Solstice, 18
  1879. Spectral, 6, 15
  1880. Star, 2, 4, 5, 6, 12, 15, 18, 20, 21, 22
  1881. STARFILE, 2, 15, 20, 24, 26
  1882. Stars, 3, 4, 5, 6, 10, 12, 13, 15, 18, 19, 20, 21, 22, 23, 29
  1883. Sun, 3, 7, 8, 9, 10, 12, 13, 14, 17, 18, 19, 22, 23
  1884. Suns, 19
  1885. Sun's, 18
  1886.  
  1887. TIME ZONE, 16
  1888. Total-Rise-Time, 22
  1889. Trail, 7, 8, 10
  1890. Trails, 4, 5, 7, 8, 18, 19, 21
  1891.  
  1892. Units, 2, 9, 17
  1893. Update, 4, 5, 9, 10, 13, 18, 19, 21, 22, 23
  1894. Update Mode, 9
  1895.  
  1896. Vertical, 5
  1897. VGA, 3, 23, 25, 26
  1898.  
  1899. Waning, 17
  1900. WARNING, 31
  1901. Waxing, 17
  1902.  
  1903. YEAR, 13, 18, 19
  1904. Years, 3, 29
  1905.  
  1906. Zenith, 2, 5, 6, 10, 24
  1907. ZONE, 14, 23
  1908. Zoom, 7, 8
  1909. Zooms, 7, 8
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.